home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / source / iffic10b.lha / IFF2Icon / IFF2Icon.doc < prev    next >
Text File  |  1993-09-02  |  5KB  |  101 lines
  1.  
  2.    ›42m ### ##### #####   ###   ###                   ›0m
  3.    ›42m  #  #     #      #   #   #                    ›0m (Version 1.0b)
  4.    ›42m  #  #     #          #   #   ###   ###  ####  ›0m
  5.    ›42m  #  ####  ####    ###    #  #   # #   # #   # ›0m
  6.    ›42m  #  #     #      #       #  #     #   # #   # ›0m
  7.    ›42m  #  #     #      #       #  #   # #   # #   # ›0m
  8.    ›42m ### #     #      #####  ###  ###   ###  #   # ›0m
  9.  
  10. The ›1mTropicDesign›0m product ›1mIFF2Icon›0m converts an IFF/ILBM-File into a Icon-File or
  11. optionally uses the default Icon. OS2.04 or better needed.
  12.  
  13. ›42m-- Table of contents ----------------------------------------------------- 1 --›0m
  14.  
  15. Section 1..................Table of contents
  16.         2..................Copyright
  17.         3..................About the program / usage
  18.         4..................Technical stuff
  19.         5..................Concluding words
  20.  
  21. ›42m-- Copyright ------------------------------------------------------------- 2 --›0m
  22.  
  23. The Copyrights  of this Freeware-program  and its  Sourcecode  are owned by the
  24. author Hanns Holger Rutz, follow this rules for (re)distribution:
  25. - you may not raise more than $3 for copying  (disk included,  postage and pak-
  26.   kage not).
  27. - the following files must be redistributed together in one directory:
  28.       ›3m IFF2Icon              ›0m(the executable)
  29.       ›3m IFF2Icon.dok          ›0m(German Doc-File)
  30.     or›3m IFF2Icon.doc          ›0m(English Doc-File)
  31.       ›3m IFF2Icon.asm          ›0m(optional Sourcecode)
  32.   All these files must stay unaltered - we're not talking filenotes,  dates and
  33.   protection-bits :-)
  34.  
  35. ›4mThe user him- or herself  is completely responseble›0m  for any damage  or loss of
  36. data (no matter,  if user or computer) caused by any of the files listed above!
  37. The Sourcecode may only be used for private learning reasons.
  38.  
  39. ›42m-- About the program / usage --------------------------------------------- 3 --›0m
  40.  
  41. Everyone knows IconEdit  -  a nice proggy,  but you can only  create very small
  42. Icons. As opposed to this program, ›1mIFF2Icon›0m is used via Shell and converts IFF-
  43. pictures of any size into Icons  -  I myself prefer painting Icons with Deluxe-
  44. Paint, a great program. Ya I know, there are numerous of programs like dis, but
  45. I had to satify myself - and I couldn't find any similar program one day...
  46. the shell-usage:
  47.  
  48. ›3mIFF2Icon [<IFFFile>] [To <IconFile>] [<IconType>] [<HighlightType>]
  49.  
  50. <IFFFile>         ›0mName of the IFF-graphic; if no name is given, my program will
  51.                   use the default Icon of the particular type;
  52. ›3m<IconFile>        ›0mName of the Icon to be created;  ".info" needn't to be added,
  53.                   and "disk.info" either - the name of the device is enough; if
  54.                   there's already an Icon with the same name, the old Icon-type
  55.                   is used,  otherwise it can  be specified  via ›3m<IconType>;  ›0mif
  56.                   such a type is missing,  the program trys  to find out,  what
  57.                   kind of file you want  to create an Icon for;  ›3mGarbage ›0mcannot
  58.                   be recognized;  if you do not specify a name, the IFF-graphic
  59.                   is saved to the default Icon;
  60. ›3m<IconType>        ›0mType of the Icon: ›3mDisk, Drawer, Tool, Project ›0mor ›3mGarbage;
  61. <HighlightType>   ›0mThis tells ›1mIFF2Icon›0m how the Icon should react  when selected:
  62.                   ›3mComplement ›0mis the default;  ›3mBackFill ›0macts similar,  but areas
  63.                   filled with the Background-color  (0)  that touch the borders
  64.                   of the Icon won't be inverted  (try it!);  ›3mImage ›0mmeans,  that
  65.                   you want  an alternative  image to  be displayed on selection
  66.                   - the program divides  the IFF-file into two vertical pieces:
  67.                   the upper  half is used  for the normal image,  the lower one
  68.                   for the alternative image;
  69.  
  70. Besides this, the program breaks,  if you neither specify ›3m<IconFile> ›0mnor ›3m<Icon-
  71. Type>, ›0mbecause it simply doesn't know what kinda default Icon you want to have.
  72. Of course,  the program uses  the ›3micon.library,  ›0mso changes on the Icons become
  73. immediately visible if you're working with your WorkBench.  Well, that's almost
  74. all, but...
  75. - for sum strange reason,  the program sucks a few KiloBytes when run.  I don't
  76.   know why,  sorry;  for all  you  programmers:  this happens  everytime I call
  77.   ›3mPutDiskObject() ›0m(no, the reason is not, that my Ram-Disk gets more full :-)
  78. - when ›1mIFF2Icon›0m  trys to find  the Icon-Type  on its own,  SoftLinks are always
  79.   treated as Directories - who cares...
  80.  
  81. So have fun with it! One last hint: For another strange reason the Icon-graphic
  82. on  your  workbench is  displayed in  the  3D-border  with margins  of 2 Pixels
  83. (above) and 1 (not 2!) Pixel (bottom) - to eliminate this cosmetic thing,  just
  84. save your  IFF-brushes  in a manner  that you  preserve  an empty  line  at the
  85. bottom; IconEdit does so, too, by the way.
  86.  
  87. ›42m-- Technical stuff ------------------------------------------------------- 4 --›0m
  88.  
  89. Well, I'm too tired, just look at da Sourcecode...
  90.  
  91. ›42m-- Concluding words ------------------------------------------------------ 5 --›0m
  92.  
  93. Jo,  folx.  Short proggy  - short comments.  Send everything you don't need any
  94. longer to this address:
  95.  
  96.         ›1mTropicDesign›0m
  97.    c/o Hanns Holger Rutz
  98. Auf dem Godenstedter Berg 17
  99.        D-27404 Zeven
  100.           Germany
  101.